home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr50 / qbreg210.zip / QBREG210.DOC < prev    next >
Text File  |  1993-04-15  |  15KB  |  353 lines

  1.  
  2.                 
  3.                 
  4.       ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  5.      
  6.            ▄███████▄  ▄████████▄  ▄████████▄  ▄█████████▄  ▄████████▄
  7.           ████▀▀▀████ ████   ████ ███▀   ▀███ ████    ▀▀▀ ████▀   ▀▀▀
  8.           ███     ███ █████████▀  ███▄   ▄███ ████▄▄▄▄▄   ████  ▄▄▄▄
  9.           ███  ▄▄ ███ ████▀▀▀███▄ █████████▀  ████▀▀▀▀▀   ████  ▀▀███
  10.           ████▄▄████▀ ████▄▄▄████ ████ ▀████▄ ████    ▄▄▄ █████▄▄▄███
  11.            ▀██████▀██ ▀████████▀  ▀██▀   ▀██▀ ▀█████████▀  ▀████████▀
  12.                                               
  13.                                              Registration Encoding System
  14.                                        Copyright (C)1993 by Lee Madajczyk
  15.                                                              Version 2.10
  16.                                                      Released: April 1993
  17.       ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  18.  
  19.       ===================================================================
  20.         A listing of Quantum Software Distribution sites can be found in
  21.                             the DISTSITE.QS file.
  22.       ===================================================================
  23.  
  24.         QBReg is a powerful, quick way to create registration codes 
  25.         from a provided name along with another number embedded into
  26.         your QuickBASIC program. QBReg returns a 9 charachter 
  27.         registration code, and can internally check whether the code
  28.         is valid. Validation is performed at the program level. 
  29.  
  30.     QBReg v2.10 ═══════════════════════════════════════════════════ i ════
  31.  
  32.                                  I N D E X
  33.  
  34.     Terms of Use . . . . . . . . . . . . . . . . . . . . . . . . 1
  35.     
  36.     Registration . . . . . . . . . . . . . . . . . . . . . . . . 1
  37.  
  38.     Overview . . . . . . . . . . . . . . . . . . . . . . . . . . 2
  39.  
  40.     Installation . . . . . . . . . . . . . . . . . . . . . . . . 3
  41.     
  42.     Using Generate . . . . . . . . . . . . . . . . . . . . . . . 4
  43.  
  44.     Using Validate . . . . . . . . . . . . . . . . . . . . . . . 5
  45.  
  46.     Using QUIK-KEY . . . . . . . . . . . . . . . . . . . . . . . 6
  47.     
  48.     Code Summary . . . . . . . . . . . . . . . . . . . . . . . . 7
  49.     
  50.     About Source Code  . . . . . . . . . . . . . . . . . . . . . 8
  51.     
  52.     Copyrights . . . . . . . . . . . . . . . . . . . . . . . . . 9
  53.  
  54.  
  55.     QBReg v2.10 ═══════════════════════════════════════════════════ 1 ════
  56.  
  57.     Registration
  58.  
  59.         Terms of Use: You may not release ANY shareware, 
  60.                 commercial, freeware, or public domain
  61.                 software without registering QBReg 
  62.                 with the CORRECT author, Lee Madajczyk
  63.                 of Quantum Software, Lenexa KS.                
  64.         
  65.         Cost: The registration cost for QBReg v2.0 is only 
  66.                 $20.00 in U.S. funds per computer for up
  67.                 to 9 computers. For registration for more
  68.                 than 10 computers, please refer to the 
  69.                 file REGISTER.FRM for more information.
  70.  
  71.                 FOREIGN ORDERS: Please send a check or money
  72.                         order drawn in US funds, as it is 
  73.                         expensive to cash a foreign check!
  74.  
  75.         Distribution: Please feel free to distribute the contents in
  76.                 this archive intact. Please also include ALL files
  77.                 in this archive. You may change archives. 
  78.                 ie: ZIP->ARJ 
  79.                 
  80.                 Shareware Dealers: Please contact me, letting me
  81.                   know that you are selling this program. After
  82.                   that has been accomplished, you are free to 
  83.                   distribute this program for any fee under
  84.                   ten United States dollars, or the equivalent.
  85.                   Writing only!
  86.  
  87.         Other: The author reserves the right to revoke any and all
  88.                 registration benefits and/or registration code from
  89.                 registered users, although this possibility will be
  90.                 rarely used.
  91.  
  92.                      Author:  Quantum Software
  93.                               Lee Madajczyk
  94.                               8012 Cottonwood
  95.                               Lenexa, KS 66215-4165
  96.  
  97.  
  98.     QBReg v2.10 ═══════════════════════════════════════════════════ 2 ════
  99.  
  100.     Overview
  101.  
  102.            QBReg was designed to provide shareware authors who use
  103.         QuickBASIC to write their software with a quick and easy 
  104.         way to implement a registration system into their program.
  105.         QBReg offers the following features:
  106.  
  107.                   ∙ Fast Processing Time
  108.                   
  109.                   ∙ Easy Error Testing
  110.                   
  111.                   ∙ Internal Validation
  112.                   
  113.                   ∙ 9 Charachter Code
  114.                   
  115.                   ∙ Two Letter Additional Identification
  116.  
  117.                   ∙ Over 100,000 Programs Numbers
  118.  
  119.  
  120.     QBReg v2.10 ═══════════════════════════════════════════════════ 3 ════
  121.  
  122.     Installation
  123.  
  124.            To install QBReg validation, you must either INCLUDE$ the 
  125.         QBREG-V.BI file which will automatically declare everything
  126.         needed for the internal validation system, or you can manually
  127.         declare the files. To manually declare the files, insert the
  128.         following statement into your main program along with the
  129.         rest of your declarations...
  130.         
  131.         DECLARE SUB Validate (ProgramNumber, Code$, Name$, FrontLet$)
  132.  
  133.  
  134.     QBReg v2.10 ═══════════════════════════════════════════════════ 4 ════
  135.  
  136.     Using Generate
  137.  
  138.            To use GENERATE, the FUNCTION that actually produces the 
  139.         code that you send to your users. To call that program, use 
  140.         the following syntax...
  141.  
  142.    DECLARE FUNCTION Generate$ (ProgramNumber, RegName$, FrontLet%, Letters$)
  143.  
  144.         ' ...All your program's code here...
  145.  
  146.         x$ = Generate$(ProgramNumber, RegName$, FrontLet%, Letters$)
  147.         
  148.         ProgramNumber: This is the number that you embed so that
  149.             Generate may make a unique code for each program.
  150.             That way, if you use QBReg in multiple programs, you
  151.             may have the same person (ie, John Olson) register 
  152.             two different programs and get two different codes.
  153.             Now, if Bob Jones has a code for one program, and 
  154.             tries to enter it for Program #2, then he will find
  155.             that the codes are different. Tricky, huh? <Grin>
  156.             Remember: ProgramNumber must be greater than 1000
  157.             and less than 104,999, but you can use ANY number
  158.             in between. You don't have to go in numerical 
  159.             sequence. I URGE that each program have a number
  160.             AT LEAST 100 numbers away from any other number of
  161.             a program.
  162.  
  163.         RegName$: This is where you enter the name of the person or
  164.             company who is registering. Ie: You get a registration
  165.             from The XYZ Billboard Company. Enter The XYZ Billboard
  166.             company here. RegName$ is NOT case sensitive. You may
  167.             take it however they enter it. QBReg automatically
  168.             changes it to it's internal format for processing. 
  169.             QBReg also trims the spaces from each side of the 
  170.             RegName$ variable, so these two stings would be the 
  171.             same...
  172.  
  173.             RegName$ = "The XYZ Billboard Company"
  174.  
  175.             RegName$ = "    The XYZ Billboard Company   "
  176.  
  177.         FrontLet%: Variable passed to QBReg telling it whether
  178.             to put the first two charachters of Letters$ in
  179.             front of the code. These two letters are encoded
  180.             into the code string, so these are not the same...
  181.  
  182.                    QB304589355           304589355
  183.  
  184.             However, if you do not call Validate with the QB
  185.             as Letters$, the first will be invalid while the
  186.             second is valid.
  187.  
  188.         Letters$: The two letters to put in front of the code.
  189.             These are embedded into the code and MUST be there
  190.             when Validate is called.
  191.  
  192.         x$: The returned code made by Generate.
  193.  
  194.     QBReg v2.10 ═══════════════════════════════════════════════════ 5 ════
  195.  
  196.     Using Validate
  197.  
  198.            To use VALIDATE, the FUNCTION which is included with your
  199.         program to check that the entered code is correct, use the
  200.         following syntax...
  201.  
  202.   DECLARE FUNCTION Validate (ProgramNumber, RegName$, Code$, FrontLetters$)
  203.  
  204.         '...and place your code here...
  205.  
  206.         X = Validate(ProgramNumber, RegName$, Code$, FrontLetters$)
  207.  
  208.         ProgramNumber: This is your embedded number. Use a different
  209.             one for each program. Make a variable (Ie: ProgramNumber)
  210.             with a unique number. This number must be greater than
  211.             1000 and less than 104,999. This means you have literally
  212.             millions of combinations for names and codes. This MUST 
  213.             be the same number as the one used in Generate to make
  214.             the code. 
  215.  
  216.         RegName$: This is where your users enters the their name.
  217.             Ie: The XYZ Billboard registers, so here they would
  218.             put their company name. RegName$ is NOT case sensitive. 
  219.             You may take it however they enter it. QBReg automatically
  220.             changes it to it's internal format for processing. 
  221.             QBReg also trims the spaces from each side of the 
  222.             RegName$ variable, so these two stings would be the 
  223.             same...
  224.  
  225.             RegName$ = "The XYZ Billboard Company"
  226.  
  227.             RegName$ = "    The XYZ Billboard Company   "
  228.  
  229.         Code$: This is the code that the user who is attempting to
  230.             register the program enters so that you can use 
  231.             Validate to see that it checks correctly.
  232.  
  233.         FrontLetters$: This is where you enter the first two letters
  234.             that should be right before the 9 charachter code. 
  235.             (Ie: If you had "QB" as the Letters$ variable while
  236.             running Generate, then FrontLetters$ should be "QB" 
  237.             IMPORTANT: IF you FrontLet%, the variable that tells
  238.             Generate whether or not to add Letters$ to the front
  239.             of the code, equal 0, then MAKE SURE that 
  240.             FrontLetters$ = CHR$(27). This is a NECESSITY, or else
  241.             the program will check that the first two letters of
  242.             Code$ = FrontLetters$. 
  243.  
  244.         X: X will return a numerical value. This is what the numbers
  245.             mean...
  246.  
  247.                   1           Correct Code entered for name.
  248.                   0           Incorrect code for entered name.
  249.                  -1           Invalid ProgramNumber.
  250.                  -2           Invalid Name entered.
  251.  
  252.  
  253.     QBReg v2.10 ═══════════════════════════════════════════════════ 6 ════
  254.  
  255.     Using QUIK-KEY
  256.  
  257.           Quik-Key is the only EXEcutable file included with this 
  258.        archive. It allows you to create a registration code without
  259.        having to load in QuickBASIC. To use, just type QUIK-KEY 
  260.        and then press the ENTER key. You will then be prompted to
  261.        enter the name to register. If you are registering
  262.        The XYZ Billboard Company, enter their name accordingly 
  263.        exactly as they spelled it, but remember that case doesn't
  264.        matter. Then you will be prompted to enter the code number
  265.        for your program. Enter the four, five, or six digit number
  266.        as asked, (Ie: 12345) and press enter. You will then be
  267.        prompted for the two-letter front-code. (Ie: AA) If there
  268.        is none, just press ENTER. You should then see this screen..
  269.  
  270.        ────────────────────────────────────────────────────────────
  271.          Registered Name     : [The XYZ Billboard Company]
  272.          Registration Number : [AA525C43A79]
  273.        ────────────────────────────────────────────────────────────
  274.  
  275.        If the name is more than 45 charachters, it will be 
  276.        truncated, but will it will still be required that the
  277.        FULL name YOU typed in be there. Now, all you have to 
  278.        do is drop The XYZ Billboard Company a letter with
  279.        their Registration Number (AA525C43A79) in it. Simple!
  280.  
  281.     QBReg v2.10 ═══════════════════════════════════════════════════ 7 ════
  282.  
  283.     Code Summary
  284.  
  285.       This is a breakdown of what I've BSed about for 5 pages <Grin>..
  286.  
  287.       GENERATE
  288.         Declaring... 
  289.        
  290.          DECLARE FUNCTION Generate$ (ProgramNumber, RegName$, FrontLet%, 
  291.            Letters$)
  292.        
  293.         Calling....
  294.  
  295.          x$ = Generate$(ProgramNumber, RegName$, FrontLet%, Letters$)
  296.  
  297.            x$ - Returns the Registration Code
  298.  
  299.       VALIDATE
  300.         Declaring...
  301.             
  302.          DECLARE FUNCTION Validate (ProgramNumber, RegName$, Code$, 
  303.            FrontLetters$)
  304.  
  305.         Calling...
  306.  
  307.          X = Validate(ProgramNumber, RegName$, Code$, FrontLetters$)
  308.  
  309.           X - Returns number about code (..Table..)
  310.  
  311.                   1           Correct Code entered for name.
  312.                   0           Incorrect code for entered name.
  313.                  -1           Invalid ProgramNumber.
  314.                  -2           Invalid Name entered.
  315.  
  316.  
  317.  
  318.     QBReg v2.10 ═══════════════════════════════════════════════════ 8 ════
  319.  
  320.     About Source Code
  321.  
  322.           No source code can be obtained for QBReg. This is for your
  323.           protection as well as mine. This way, nobody knows how I
  324.           encode that registration stuff. These are the views of 
  325.           Lee Madajczyk AND Quantum Software. (Especially since
  326.           I AM Quantum Software <Grin>) 
  327.  
  328.  
  329.     QBReg v2.10 ═══════════════════════════════════════════════════ 9 ════
  330.     
  331.     Other
  332.  
  333.         Credits: 
  334.                 Charlie Lacz:  Beta tester
  335.                 Lee Lefler, Infinity BBS
  336.  
  337.         Copyrights:
  338.                 Program / Documentation of QBReg v2.00
  339.                         Copyright (C)1993 by Lee Madajczyk
  340.  
  341.         Problems?...
  342.                 Contact me at:  Quantum Software
  343.                                 Lee Madajczyk
  344.                                 8012 Cottonwood
  345.                                 Lenexa, KS  66215
  346.  
  347.                 Include a Self-addressed stamped envelope
  348.                 UNLESS you are a registered user or are 
  349.                 including your Registration. Even then, I
  350.                 will be very careful about answering because
  351.                 you should not use the program without 
  352.                 registering. 
  353.